Pandoc使用技巧 |
您所在的位置:网站首页 › pandoc 转换图片 › Pandoc使用技巧 |
Pandoc可以实现常用文档格式之间的相互转换,包括HTML、LaTeX、docx、Markdown等。 语法pandoc [options] inputfiles Pandoc采用UTF-8编码方案处理输入输出文件。 常用参数说明--from=FORMAT, -f FORMAT --to=FORMAT, -t FORMAT 指定输入输出文件的格式,如果没有指定输入输出文件格式,则通过文件扩展名推测文件格式。使用以下命令列出支持的输入输出文件格式: pandoc --list-input-formats pandoc --list-output-formats使用FORMAT+EXTENSION和FORMAT+EXTENSION可以增减相应格式中的一个或多个扩展选项。使用以下命令列出Pandoc支持的扩展 pandoc --list-extensions pandoc --list-extensions=FORMAT--output=FILE, -o FILE 如果没有指定输出文件,则输出至标准输出(stdout),默认格式为HTML。 --file-scope 如果给出多个输入文件,则默认将多个文件拼接起来(添加空行分隔)。使用此选项分别转换每一个文件。 -standalone, -s 默认生成文档片段。使用此选项后,Pandoc将使用一个模板来添加必要信息,以生成完整的文件(HTML、LaTeX等)。 --template=FILE 当使用standalone选项时,Pandoc默认采用内置模板。使用template选项指定创建文档所需的模板后,Pandoc将默认生成完整文件。内置模板可以通过以下命令输出: pandoc -o file_template --print-default-template=FORMAT pandoc -o file_template -D FORMAT其中FORMAT表示输出格式。 模板中包含变量,用于自定义模板。变量可用过命令行参数提供,或从文档的元数据中查找(YAML元数据语句块或-M/--metadata选项)。模板中的变量表示方法为 $title$针对变量variable的条件语句表示方法 $if(variable)$ X $else$ Y $endif$根据变量的值,相应的语句块将被写入输出文件。类似地,如果变量author是一个数组,则可以使用循环语句 $for(author)$ X $endfor$--metadata=KEY[:VAL], -M KEY[=VAL] 设置文档元数据:指定KEY的值为VAL。如果没有提供VAL,则KEY默认值为true。 --variable=KEY[:VAL], -V KEY[=VAL] 设置模板元数据。 --metadata-file=FILE 从指定的YAML(或JSON)文件中读取元数据。命令行提供的元数据信息将覆盖文件中的信息。 --css=URL, -c URL 指定CSS样式表。 --number-sections, -N 对标题进行编号(LaTeX,HTML等,不包括docx)。 转换为HTML 数学公式渲染--mathjax[=URL] --mathml --katex[=URL] 转换为PDF/LaTeXPandoc默认使用pdflatex生成PDF,也可以使用ConTeXt,pdfroff或HTML/CSS-to-PDF引擎(wkhtmltopdf , weasyprint或prince)。 LaTeX 参数列表 -o output.pdf --pdf-engine=xelatex --template=FILE source.md 说明--pdf-engine=PROGRAM 指定生成PDF的排版程序,用于LaTeX排版的程序包括:pdflatex, lualatex, xelatex, latexmk等。 --print-default-template=latex 输出默认的latex文档模板。Pandoc可以采用此模板将Markdown文档转换为tex源码文档( Pandoc默认模板不能很好支持中文)。pm-template.tex是一个可用的模板。 为了调试PDF的创建,可以先输出tex文件并使用latex编译器单独编译。 使用latex时,需要保证本地有必要的包(可以根据编译信息判断是否缺少必要的包,使用MikTeX可以按需下载缺少的包。) 可选参数--listings 在LaTeX文档中使用listings包来格式化代码块。 --biblatex, --natbib 指定处理参考文献的程序。 --bibliography=FILE 设置文档元数据中的参考文献信息,等效于 --metadata bibliography=FILE --filter pandoc-citeproc如果使用了biblatex或natbib选项,则等效于 --metadata bibliography=FILE 转换为Word文档 (DOCX) 参数列表: -o output.docx --reference-doc=custom.docx source.md--reference-doc=FILE 使用指定的文件作为输出文件的格式参考。参考文件的内容被忽略,只使用其中的样式和文档属性(包括边界、页面尺寸、页眉页脚等)。通过以下命令获取系统中的默认模板(reference.docx)。 pandoc -o custom.docx --print-default-data-file=reference.docx注意:需要在--print-default-data-file选项之前使用-o选项以重定向输出。 用户可以按需修改并更新上述输出的默认参考文档中的样式,并将其作为转换的参考模板。 Word文档转换为其他类型--extract-media= DIR 提取word文档中的图片等多配体文件到目标文件夹,并在目标文件中设置对这些文件的引用。 转换为epub--epub-cover-image=FILE 添加封面。 --epub-metadata=FILE 添加元数据。 --epub-embed-font=FILE 嵌入字体。 文档元数据和选项使用YAML提供文档元数据,可设置的信息参考Pandoc手册。基本使用方法如下所示。 # comments title: "This is the title" indent: true linestretch: 1.25 author: - Author One - Author Two description: | # paragraphs This is a long description. It consists of two paragraphs |
CopyRight 2018-2019 办公设备维修网 版权所有 豫ICP备15022753号-3 |